package com.ruoyi.business.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.ruoyi.business.domain.VisitorRecords;
import com.ruoyi.business.param.VisitorCountXmlParam;
import com.ruoyi.business.vo.VisitorCountXmlVo;
import com.ruoyi.business.vo.VisitorRecordsExportVo;
import org.apache.ibatis.annotations.Mapper;

import java.util.List;
import java.util.Map;

/**
 * 访客记录Mapper接口
 * 
 * @author qiancheng
 * @date 2025-06-13
 */
@Mapper
public interface VisitorRecordsMapper extends BaseMapper<VisitorRecords>
{
    /**
     * 查询访客记录
     * 
     * @param id 访客记录主键
     * @return 访客记录
     */
    public VisitorRecords selectVisitorRecordsById(Long id);

    /**
     * 查询访客记录列表
     * 
     * @param visitorRecords 访客记录
     * @return 访客记录集合
     */
    public List<VisitorRecords> selectVisitorRecordsList(VisitorRecords visitorRecords);

    /**
     * 导出查询访客记录列表
     *
     * @param visitorRecords 访客记录
     * @return 访客记录集合
     */
    public List<VisitorRecordsExportVo> selectVisitorRecordsListExport(VisitorRecords visitorRecords);

    /**
     * 新增访客记录
     * 
     * @param visitorRecords 访客记录
     * @return 结果
     */
    public int insertVisitorRecords(VisitorRecords visitorRecords);

    /**
     * 修改访客记录
     * 
     * @param visitorRecords 访客记录
     * @return 结果
     */
    public int updateVisitorRecords(VisitorRecords visitorRecords);

    /**
     * 删除访客记录
     * 
     * @param id 访客记录主键
     * @return 结果
     */
    public int deleteVisitorRecordsById(Long id);

    /**
     * 批量删除访客记录
     * 
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteVisitorRecordsByIds(Long[] ids);

    /**
     *  首页->>访问数据->>获取昨日访客数据
     * @return
     */
    Map<String, Object> getYesterdayVisitStats();

    /**
     *  首页->>访问数据->>获取今日访客数据
     * @return
     */
    Map<String,Object> getTodayVisitStats();

    /**
     *  首页->>访问数据->>获取本月访客数据
     * @return
     */
    Map<String,Object> getMonthVisitStats();

    /**
     *  首页->>访问数据->>获取上月访客数据
     * @return
     */
    Map<String,Object> getLastMonthVisitStats();

    /**
     * 首页->>实验次数->>根据年月查询实验平台的实验次数
     * @param VCountXmlParam
     * @return
     */
    public List<VisitorCountXmlVo> getCountByDate(VisitorCountXmlParam VCountXmlParam);

    /**
     * 首页->>实验次数->>根据周查询实验平台的实验次数
     * @param VCountXmlParam
     * @return
     */
    public List<VisitorCountXmlVo> getCountByWeek(VisitorCountXmlParam VCountXmlParam);

    /**
     * 首页->>访问数据->>更多->>根据周获取每天访问列表
     *
     * @param VCountXmlParam 访客记录
     * @return 访客记录集合
     */
    public List<VisitorRecords> selectVisitorListByWeek(VisitorCountXmlParam VCountXmlParam);

    /**
     * 首页->>访问数据->>更多->>导出数据->>导出根据周获取每天访问列表
     *
     * @return 访客记录集合
     */
    List<VisitorRecordsExportVo> selectVisitorListByWeekExport(VisitorCountXmlParam vCountXmlParam);
}
